package com.zhiwen.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.zhiwen.domain.dto.RegisterDTO;
import com.zhiwen.domain.dto.UserDTO;
import com.zhiwen.domain.entity.User;
import com.zhiwen.domain.vo.UserVO;

import java.util.List;
import java.util.Map;

/**
 * 用户服务接口
 */
public interface UserService extends IService<User> {

    /**
     * 根据用户名查询用户
     */
    User getByUsername(String username);

    /**
     * 根据邮箱查询用户
     */
    User getByEmail(String email);

    /**
     * 根据手机号查询用户
     */
    User getByMobile(String mobile);

    /**
     * 根据账号查询用户(用户名/邮箱/手机号)
     */
    User getByAccount(String account);

    /**
     * 用户注册
     */
    UserVO register(RegisterDTO registerDTO);

    /**
     * 用户信息脱敏
     */
    UserVO getUserVO(User user);

    /**
     * 获取用户信息
     *
     * @param id 用户ID
     * @return 用户信息
     */
    UserVO getUserInfo(Long id);

    /**
     * 更新用户信息
     *
     * @param userDTO 用户信息
     * @return 更新后的用户信息
     */
    UserVO updateUserInfo(UserDTO userDTO);

    /**
     * 分页获取用户列表
     *
     * @param page 分页对象
     * @param keyword 搜索关键词
     * @return 用户分页列表
     */
    Page<UserVO> getUserPage(Page<User> page, String keyword);

    /**
     * 设置用户状态（禁用/启用）
     *
     * @param userId 用户ID
     * @param status 状态(0-禁用, 1-启用)
     * @return 是否成功
     */
    boolean updateUserStatus(Long userId, Integer status);

    /**
     * 设置用户角色
     *
     * @param userId 用户ID
     * @param role 角色(1-普通用户, 2-专家用户, 3-管理员)
     * @return 是否成功
     */
    boolean updateUserRole(Long userId, Integer role);

    /**
     * 获取用户统计数据（管理员功能）
     *
     * @return 包含各种统计数据的Map，例如：
     *         - totalUsers: 总用户数
     *         - activeUsers: 活跃用户数
     *         - newUsersToday: 今日新增用户数
     *         - newUsersThisWeek: 本周新增用户数
     *         - newUsersThisMonth: 本月新增用户数
     *         - usersByRole: 按角色统计的用户数
     */
    Map<String, Object> getUserStatistics();

    /**
     * 批量删除用户（管理员功能，软删除）
     *
     * @param ids 用户ID列表
     * @return 成功删除的数量
     */
    int batchDeleteUsers(Long[] ids);

    /**
     * 批量获取用户信息
     *
     * @param userIds 用户ID列表
     * @return 用户ID与UserVO的映射
     */
    Map<Long, UserVO> getUserVOMap(List<Long> userIds);
}
